This ReadMe file contains some iportant information about 24U Appearance OSAX, such as system requirements, installation guide, quick start, troubleshooting, licence notice, contact information, and copyright statement.
1. Introduction
24U Appearance OSAX is so called Scripting Addition. It extends AppleScript™ by a few very easy-to-use commands to post notifications, display enhanced Appearance alerts, floating message windows, floating progress indicators, and even better dialogs such as this one:
2. System Requirements
Minimum requirements:
- Macintosh with 68020 processor
- Mac OS 7.5 with Appearance installed
- Mac OS 8.6 and AppleScript 1.3.7 for floating message windows and progress indicators
Recommended configuration:
- Any Power Macintosh, PowerPC equipped PowerBook, iMac, or iBook
- Mac OS 8.6 or newer, AppleScript 1.3.7 or newer, Appearance 1.1 or newer
3. Installation
To install 24U Appearance OSAX, follow these easy steps:
1. If you did not do this yet, please download and expand the 24U Appearance OSAX archive.
2. Open the expanded 24U Appearance OSAX folder.
3. Remove any previous version of Appearance OSAX from your “Scripting Additions” folder.
4. Copy the “24U Appearance OSAX” icon into your “Scripting Additions” folder.
You can also drop the “24U Appearance OSAX” icon on your closed System Folder icon.
5. If you are going to use floating windows, copy the “TSM Fix 1.0.3” extension icon into your Extensions folder.
You can also drop the “TSM Fix 1.0.3” icon on your closed System Folder icon.
6. If you have installed also the “TSM Fix 1.0.3” extension, restart your computer.
4. Quick Start
24U Appearance OSAX is really very easy to use. The best way to understand what it can do is to go through the included Sample Scripts. Simply run each of the applets, step by step, and examine their behaviour. When you are done, you can simply drag any of the applets and drop it onto the Script Editor's icon. The applet will open in an editing window so that you will see how it was created. You can even modify the code and test how your changes affect the applet's behaviour.
5. Troubleshooting
Before you contact our technical support regarding problems or difficulties using 24U Appearance OSAX, please check if your issue is not listed below:
• My floating message or progress indicator does not respond to mouse clicks.
The floating windows can have problems getting mouse event when the script which opened them is just processing an Apple Event. This is a limitation of current version of 24U Appearance OSAX. There are two possible workaround for this issue. The first is to perform all your actions in a short idle event handler. The other one is to create another applet which you will use only for displaying the windows.
• I cannot use the buttons in a progress indicator, because they don't work.
If you don't care about ability to move or collapse the progress indicator's window, please check the sample script called “command progress”. This script presents a simple workaround that can be enough in most cases.
• I cannot post notification more than once.
You probably don't remove the previously posted notification. A new notification cannot be posted until the previous one is removed with the “remove notification” command.
• I can display a “better” dialog but I don't know how to get data from it?
There is a sample script called “display better dialog” in the “Sample Scripts” folder. Open the script in your script editor, and you'll see couple of examples on how to gather data from different kinds of dialogs.
If your problem is not listed above or if the recommended solution does not work for you, please contact our technical support by e-mail at <support@24u.cz>.
6. Shareware Notice
Please note that 24U Appearance OSAX is SHAREWARE. That means it is not free and you have to pay a licence fee if you want to keep it. You can install 24U Appearance OSAX and try it for the period of 14 days. After this period, 24U Appearance OSAX can stop working and require a registration code. We will provide you with your registration code after you pay for your licence.
You can freely distribute 24U Appearance OSAX as long as you distribute the original compacted archive untouched and you don't charge money for the distribution. If you want to distribute 24U Appearance OSAX on a physical medium, such as CD-ROM, or if you want to distribute it in other form than the original compacted archive, you should ask for our permission.
You can find detailed licence terms in the file named “Licence Agreement”.
7. Contact Information
You can contact us at one of the following addresses. We prefer contacting us via e-mail, but you can use any other method if e-mail is not good enough for you.
E-mail: info@24u.cz general information about our products and our company
eval@24u.cz free evaluation codes registration
sales@24u.cz paid licences ordering and registration
